Skip to content

gh-87577: Document that wm_manage does not accept ttk widgets#152532

Merged
serhiy-storchaka merged 1 commit into
python:mainfrom
serhiy-storchaka:gh-87577-wm-manage-ttk-docs
Jun 29, 2026
Merged

gh-87577: Document that wm_manage does not accept ttk widgets#152532
serhiy-storchaka merged 1 commit into
python:mainfrom
serhiy-storchaka:gh-87577-wm-manage-ttk-docs

Conversation

@serhiy-storchaka

@serhiy-storchaka serhiy-storchaka commented Jun 28, 2026

Copy link
Copy Markdown
Member

Tk's wm manage accepts only the classic frame, labelframe and toplevel widget types, so wm_manage() fails with tkinter.ttk.Frame and tkinter.ttk.LabelFrame:

_tkinter.TclError: window ".!frame" is not manageable: must be a frame, labelframe or toplevel

This is confusing for users who work mostly with ttk widgets. Note in the manage() documentation that the tkinter.ttk versions are not accepted.

@serhiy-storchaka @claude
pythongh-87577: Document that wm_manage does not accept ttk widgets
a17331a 
wm_manage() works only with the classic tkinter Frame, LabelFrame and
Toplevel widgets, not their tkinter.ttk counterparts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Jun 28, 2026
@bedevere-app bedevere-app Bot mentioned this pull request Jun 28, 2026
Closed
@serhiy-storchaka serhiy-storchaka added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jun 28, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jun 28, 2026
@read-the-docs-community

read-the-docs-community Bot commented Jun 28, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33345717 | 📁 Comparing a17331a against main (41cc78a)

  🔍 Preview build  

1 file changed
± library/tkinter.html

@serhiy-storchaka serhiy-storchaka merged commit 2670cb0 into python:main Jun 29, 2026
42 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Jun 29, 2026
@miss-islington-app

miss-islington-app Bot commented Jun 29, 2026

Copy link
Copy Markdown

Thanks @serhiy-storchaka for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

@serhiy-storchaka serhiy-storchaka deleted the gh-87577-wm-manage-ttk-docs branch June 29, 2026 06:02
@bedevere-app

bedevere-app Bot commented Jun 29, 2026

Copy link
Copy Markdown

GH-152543 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 pre-release feature fixes, bugs and security fixes label Jun 29, 2026
@bedevere-app

bedevere-app Bot commented Jun 29, 2026

Copy link
Copy Markdown

GH-152544 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Jun 29, 2026
@bedevere-app

bedevere-app Bot commented Jun 29, 2026

Copy link
Copy Markdown

GH-152545 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label Jun 29, 2026
serhiy-storchaka added a commit that referenced this pull request Jun 29, 2026
@miss-islington @serhiy-storchaka @claude
[3.15] gh-87577: Document that wm_manage does not accept ttk widgets (G…
4f14014 
…H-152532) (GH-152543)

wm_manage() works only with the classic tkinter Frame, LabelFrame and
Toplevel widgets, not their tkinter.ttk counterparts.
(cherry picked from commit 2670cb0)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
serhiy-storchaka added a commit that referenced this pull request Jun 29, 2026
@miss-islington @serhiy-storchaka @claude
[3.14] gh-87577: Document that wm_manage does not accept ttk widgets (G…
64feef1 
…H-152532) (GH-152544)

wm_manage() works only with the classic tkinter Frame, LabelFrame and
Toplevel widgets, not their tkinter.ttk counterparts.
(cherry picked from commit 2670cb0)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
serhiy-storchaka added a commit that referenced this pull request Jun 29, 2026
@miss-islington @serhiy-storchaka @claude
[3.13] gh-87577: Document that wm_manage does not accept ttk widgets (G…
bb00fc0 
…H-152532) (GH-152545)

wm_manage() works only with the classic tkinter Frame, LabelFrame and
Toplevel widgets, not their tkinter.ttk counterparts.
(cherry picked from commit 2670cb0)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@serhiy-storchaka